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Chapter 1 



Disk Basics 



This text describes the operation of the Shugart SA400 Mini-floppy 
disk drive in the Radio Shack TRS-80 Model I Microcomputer system. It 
is divided into five chapters. The first chapter. Disk Basics, describes 
the general operation of minifloppy disks. Chapter 2, Shugart SA400 
operation, describes the operation of the disk drive itself in terms of 
interface signals and functions. The next chapter is concerned with 
operation of the Western Digital FD1771B-01 Floppy Disk 
Formatter/Controller chip used in the TRS-80 Model I Expansion 
Interface. Chapter 4 shows how the expansion interface decodes disk 
addressing and commands. The last chapter shows how Radio Shack 
software communicates to the disk and how one may do machine 
language (assembly language) and limited Basic-level programming of 
disk systems. Appendices provide related material, such as controller 
commands and disk format. 

A floppy disk system is made up of a disk drive or drives, 
a controller, and the microcomputer. In our case, the microcomputer is 
the Radio Shack TRS-80 Model I, the controller is the Western Digital 
FD1771B-01, and the disk drive is the Shugart SA400. A block diagram 
of the TRS-80 disk system is shown in Figure 1. As with other units in the 
TRS-80 system, the CPU communicates over 16 address lines, A15 
through AO, eight data lines, D7 through DO, and a set of control lines 
that specify whether reading or writing and other functions are being 
performed. The controller for the disk{s) interprets commands sent to it 
ov€r the data lines and translates these commands into disk-type 
commands that the Shugart SA400 can recognize. The single chip 
controller is a 40-pin chip that is effectively a microcomputer in itself, and 
replaces a hundred chips or so for a TTL (Transistor-Transistor Logic) 
design. Commands are sent to the disk drive by the controller chip to 
perform functions for head positioning and reading and writing, and the 
"status" of the drive is returned to the controller chip. We will be talking 
about the operation of each of these component parts in future chapters, 
but for the time being, let us concern ourselves with how the data is 
stored on the "diskette" and some of the physical attributes of the 
diskette and disk drive. . - -t.- r- ; 



Figure 1. Block Diagram of the TRS-80 Disk System 
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When the disk drive is mentioned in this text, we will refer to the "disk" 
or "drive" or "disk drive". When the recording media is mentioned, the 
term "diskette" will be used. The diskette used in the Shugart SA400 is 
basically a 5% inch diameter flexible or "floppy diskette made up of 
plastic, coated with a magnetic oxide similar to that used for recording 
tapes. The diskette fits in a square holder for protection and ease of 
storage. The square holder fits inside the SA400, which is really only a 
device which spins the diskette and moves a recording head along a 
radius while the diskette is spinning, along with associated electronics to 
read and write data. The recording head reads flux changes or produces 
flux changes for writing, similar to a tape recording head. Other disk 
electronics control head positioning, protection of the diskette from 
writes, and other functions. 

The diskette spins at 300 revolutions per minute. As the diskette 
revolves, the head can be moved along a radius towards the center or 
back again in small increments. Each discrete position over the diskette 
defines a "track", as shown in Figure 2. There are 35 tracks for a Shugart 
SA400, and therefore 35 valid positions along the radius. When the head 
is positioned along the radius over a track it can read the data along the 
concentric circle defined by the track. This circle is divided into ten 
"sectors", each occupying one-tenth of the circumference of the track. 
The circumference of the innermost circles or tracks are obviously less 
than the outermost tracks, but the content of the tracks is the same, 
although the data is packed a little more tightly into the innermost 
tracks. This may cause possible "data separation" problems when 40 
track formatting is attempted. 



Figure 2. The Organization of the Diskette 
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Once positioned over a track, sector can be sensed by a small sector 
index hole in the diskette which causes a signal to be generated by the 
diskette when the index hole passes five times per second. 

Each sector on the diskette holds 256 data bytes. The entire track can 
hold 256 times 20 bytes, or 2560 bytes of data. As there are 35 tracks, the 
entire diskette can hold 89,600 bytes of data. This data is recorded in 
send fashion along the track, so that one track holds 2560 times 8 bits of 
data, or 20,480 bits along the circumference. Data recorded along every 
track then, can be viewed as a long string of data bits, starting from 
sector of the track and ending at data bit 20479, the last data bit of 
sector 9. In addition to the data stored in a sector "record" however, 
there are other bit patterns that are not user data. This data identifies the 
sector address, defines a "gap", stores a checksum of user data, and 
contains other relevant data pertaining to reading and writing the sector. 
This data must be put on the diskette by a special "formatting" process 
prior to user data being stored on the diskette. One can look at the 
formatting process as supplying a skeletal set of records with proper 
sector gaps and identification data, and large unused areas awaiting user 
data. The formatting process and actual track format is described later 
in this text. 

If data is to be read or written to a sector, the head is first positioned 
over the proper track, through 34. Information about where programs 
or data are to be found on the diskette must be maintained by the system 
user in a software "directory" that contains a file name and track and 
sector address, along with other particulars; Track positioning is called a 
"seek" operation, and takes about 25 milliseconds (l/40th of a 
second) to go from track to track, a little under a second to go from track 
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to track 34 (worst case), and about 450 milliseconds for the average 
seek that must traverse about one-half the number of sectors. 

Once the head is positioned over the proper track, the desired sector 
can be read. Prior to sector read (or write) the program passes a sector 
address (0 through 9) to the disk controller, just as it had previously 
passed a track address before the seek. The disk controller senses when 
the proper sector spins under the head by detecting the index hole and 
identification data from the diskette. If the sector has just passed the 
head when the sector read or write command is given, then the time 
required to read or write the sector is about one revolution time plus 
one-tenth of a revolution time for read or write. As the diskette is 
spinning at 5 revolutions per second, this worst case "sector latency" will 
be about 220 milliseconds. The average access for reading or writing to a 
sector is about one-half revolution or one-tenth of a second. Once 
positioned over the proper sector, data is transferred at 2560 bytes per 
revolution, or about 12,800 bytes per second for user data. (The actual 
data transfer rate is closer to 15,625 bytes per second because both user 
data and identification data is being read.) 

The "average access" for records dispersed all over the diskette 
would be the average seek time plus average sector time plus data time, 
or about 450 milliseconds plus 100 milliseconds plus 20 milliseconds 
equals 570 milliseconds per 256 byte sector, or roughly one-half second. 
The average access for data accessed "sequentially" in adjoining sectors 
and tracks would be about 100 milliseconds (basically average sector 
access time) for processing of 256 byte records. Quite a change from 500 
baud (50 characters per second) cassette tape! 

Another factor to consider in computing access times is motor turn- 
on time. When an Input/Output (I/O) operation is performed the disk 
drive motor must first be turned on and brought up to speed. This takes 
less than a second. If a series of I/O operations are to be performed, the 
motor is kept on by continuously "selecting" the drive, so that the one 
second turn-on time occurs only at the beginning of the set of 
operations. If the operations occur greater than about three seconds 
apart, however, the motor must be turned on for each set of operations. 

Data is normally read and written one sector at a time, although it is 
possible to read one to ten sectors worth with one command. Checks 
are provided for valid data, positioning errors, and other "disk status" as 
in any complicated I/O device. 

Each diskette square holder has a small notch cutout that can be 
covered over with a label or tape. When this is done the diskette is 
"write-protected" and data can be read from, but not written to, the 
diskette. , 



The TRS-80 permits up to four drives to be connected to the 
expansion interface box with one cable. These are numbered as "0", "1", 
"2", and "3". Drive always contains a diskette with the TRS Disk 
Operating System (or TRSDOS) and utility program on the first 34K 
bytes or so of the diskette. The "default" drive is disk drive number for 
commands that do not specify a drive number, and the "bootstrap" 
program is also contained in sector 0, track of the diskette in drive 0. 

Now that we have seen in general how disk storage functions, we will 
continue by discussing the Shugart SA400 in the next chapter, followed 
by the controller chip, addressing, and disk programming. 



Chapter 2 



Shugart SA400 



This chapter will describe the Shugart SA400 disk drive as used in the 
Radio Shack TRS-80. The SA400 drive is essentially unmodified 
internally by Radio Shack, the exception being minor addressing 
modifications and a terminator that is connected to a dip socket on the 
disk electronics board. This terminator is installed only in drive 
number 1, hence the difference in the two types of drives supplied. The 
SA400 requires power supplies of +12 volts and +5 volts DC. These are 
installed on the rear of the cabinet for the drives (the cabinet or cover is 
another optional item). Initially, Radio Shack had a problem with heat 
dissipation for the drive power supplies, but this has been alleviated in 
later drives. Cabling is also supplied by Radio Shack and is discussed 
later in this text. The cable is a simple ribbon cable. 

Another point that should be mentioned here is that the Shugart 
SA400 has become something of a de facto standard for minifloppy disk 
drives. Several other manufacturers make drives that are presumably 
plug-to-plug compatible with the SA400 and could be used in place of the 
SA400. 

Physical Data 

The SA400 is very compact, so much so that many microcomputer 
manufacturers have installed the entire drive in existing cabinetry to 
provide a disk system. The drive measures 5% inches high by SV^ inches 
wide by 8 inches deep (plus power supply). Weight is about three 
pounds. There are two basic assemblies in the SA400, the drive 
mechanism itself, and a printed circuit board associated with head 
electronics and interfacing. The drive mechanism uses a DC drive motor 
with a servo speed control and integral tachometer. The motor rotates a 
spindle through a belt drive system. The drive has a mechanical interlock 
on a door latch to insure that the diskette is properly inserted. 

The read/write head is ceramic and is mounted on a carrier 
assembly. The head assembly is positioned through the use of a spiral 
cam. The cam is driven by a stepping motor that positions the cam and 
head by rotating the cam in discrete increments (if you are like me, you 
are falling asleep by now - pull off the disk cover, and you will immediately 



see th mechanism which steps the head assembly from track to 
track. I 's better than a long description, although I don't want to offend 
any mechanical engineers out there). 

Printed Circuit Board Electronics 

The printed circuit board assembly contains electronics to perform 
the following functions: 

1. Detect the sector index mark in the diskette. 
. 2. Position the head to the proper diskette track. 

3. Load the head (press the diskette against the read/ write head in 
preparation for reading and writing. 

4. Generate signals in the head to write data or read flux changes 
from the diskette, including merging data and clock signals. 

5. Detect the write protect condition. 

6. Detect when the drive is selected. 

The functions above are uncomplicated, with the exception of the 
read and write data function. Data written to the diskette is merged with 
a clock signal. When the combined data/clock signal is read from the 
diskette the clock and data must be separated by special circuitry. In this 
case the circuitry is contained in the Western Digital FD1771B-01 chip, 
along with circuitry to create the merged clock/data. The effect of 
merging the data and clock is to produce a pulse train that is frequency 
modulated. Whenever a one bit is generated, two pulses result during a 
clock cycle, while only one pulse is generated for a zero bit. A typical 
string of data read from a diskette is shown in Figure 1. The recording 
method is shown for information only, as one should never have to deal 
with data at this raw level, unless possibly troubleshooting an inoperative 
disk drive. 

Figure 1. Data Recording 
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Control Signals 

The standard Shugart SA400 interface signals are shown in Table 1. 
These are the signals that are present on the disk drive printed circuit 
board connector that attaches to the TRS-80 cabling. We will discuss 
these signals in general initially, without regard to the TRS-80, and 
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describe in chapter three how they relate to the FD1771B-01 controller 
chip (or vice versa). 



TRS-80, however, selection is determined by position along the cable, 
and if Select is low, drive 1 is selected, if Select 1 is low drive 2 is 
selected, and so forth. 



Tabic 1. SA400 Interface Signals 



Disk to Controller 

Index 
Track 
Write Protect 
Read Data 



Controller to Disk 

Select 

Select 1 

Select 2 

Select 3 

Drive Motor Enable 

Direction 

Step 

Write Data 

Write Enable 

Assume the disk is off. When power is supplied and the signal Drive 
Motor Enable goes low, the drive motor "comes up" to a speed of 300 
revolutions per minute and stabilizes at this speed in less than one 
second. When this signal goes high, the drive motor stops in less than a 
second. In the TRS-80, the motor is normally off and is only turned on for 
reading and writing. 

The Direction and Step signals are outputs to the disk that control the 
stepping of the drive head. If Direction is low and a Step pulse is issued, 
the head will step over towards the center of the disk by one track. If 
Direction is high and a Step pulse is issued, the head will step one track 
away from the center of the diskette. Obviously, to step from the 
outermost track (0) to the innermost track (34) requires 34 step pulses. 
Each Step pulse goes from high to low for a duration of 200 nanoseconds 
(200 billionths of a second) to 2 milliseconds (2 thousandths of a second). 

The Index signal is an output from the disk drive which appears as a 
pulse every 200 milliseconds at the beginning of a track. It is generated by 
the appearance and detection of the index hole in each diskette five 
times per second. 

Signal Track is another output from the disk indicating that the head 
is positioned over the outermost track, track 0. This causes signal 
"Track 0" to go low. 

Signal Write Protect is low whenever an opaque label is put over the 
diskette write-protect notch. This signal informs the controller that 
writing data to the disk is not possible. 

Signals Select through Select 3 are used to select one of four drives. 
The drive number within the SA400 is determined by a dip shunt. In the 



Reading and Writing 



The normal sequence before reading or writing data is to turn on the 
drive motor and to then position the head by stepping until the head is 
positioned over the desired track. Now data can be read or written after 
the motor reaches full speed (one second) and the desired sector 
appears under the head. The controller chip issues the proper number of 
Step commands in the proper Direction to postion the head and may 
also control Drive Motor Enable, although this is not done in the TRS-80 
(addressing the disk turns on the motor for a period of time). 

When a write is to be performed, the Write Enable line must first go 
low to signal the drive that a write will be taking place. The current in the 
head is turned on by the Write Enable signal in preparation for the write. 
Writes cannot be performed unless Write Enable is low. 

Data to be written is sent to the disk via the Write Data line. Each high 
to low transition on this line causes a magnetic flux change in the 
read/write head. The recording technique used is the previously 
described frequency-modulation type (double frequency) in which data 
and clock form a combined Write Data signal. 

Data being read is sent from the disk by means of the Read Data line. A 
data pulse is sent for each flux transition on the diskette. 

Both read and write data appears as a series of serial pulses. The 
controller performs a serial to parallel conversion in data read from the 
disk and a parallel to serial conversion for data written to the disk. 

In essence then, there are really not many things that the disk can do. 
It can only step one track at a time in one direction, write a data pulse, 
read a data pulse, and report back on the status of the index mark, track 
position, and write protect. All of the other functions such as reading a 
sector, formatting, writing a sector, stepping more than one sector to a 
given track, and finding a given sector must all be implemented in 
external (to the disk) logic. In the next chapter we will see how the floppy 
disk controller implements these functions and others. 

The following table recaps disk signals, lists their pin numbers for the 
SA400 connector and the TRS-80 cabling, and cross references the 
Shugart name with TRS-80 terminology. 
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Table 2. SA400/TRS-80 Signals 



Shugart Pin #, Signal Name TRS-80 Cable Pin #, Signal Name 



1 


spare 


1 


ground 


2 


spare 


2 


not used 


3 


spare 


3 


ground 


4 


spare 


4 


not used 


5 


spare 


5 


ground 


6 


spare 


6 


not used 


7 


ground 


7 


ground 


8 


Index 


8 


Index Pulse 


9 


ground 


9 


ground 


10 


Select 


10 


DSl 


11 


ground 


11 


ground 


12 


Select 1 


12 


DS2 


13 


ground 


13 


ground 


14 


Select 2 


14 


DS3 


15 


ground 


15 


ground 


16 


Drive Motor Enable 


16 


Motor On 


17 


ground 


17 


ground 


18 


Direction 


18 


Direction Select 


19 


ground 


19 


ground 


20 


Step 


20 


Step 


21 


ground 


21 


ground 


22 


Write Data 


22 


Write Data 


23 


ground 


23 


ground 


24 


Write Enable 


24 


Write Gate 


25 


ground 


25 


ground 


26 


Track 


26 


Track Zero 


27 


ground 


27 


ground 


28 


Write Protect 


28 


Write Protect 


29 


ground 


29 


ground 


30 


Read Data 


30 


Read Data 


31 


spare 


31 


ground 


32 


Select 3 (jumper) 


32 


DS4 


33 


spare 


33 


ground 


34 


spare 


34 


not used 



Chapter 3 
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Western Digital FD1771B-01 



The Western Digital FD1771B-01 is a 40 pin floppy disk controller chip 
which enables the TRS-80 to issue simple commands for head 
positioning and reading and writing of data. The controller chip then 
performs the complicated timing functions for implementation of these 
commands. The commands that may be issued to the FD1771B-01 are: 

1. Restore. Move the head to track zero. 

2. Seek. Find the currently specified track. 

3. Step. Step the head in the last direction. 

4. Step In. Step the head one track in. 

5. Step Out. Step the head one track out. 

6. Read. Read one byte of user data. 

7. Write. Write one byte of user data. 

8. Read Address. Read identification field. 

9. Read Track. Read entire track. 

10. Write Track. Write entire track. 

11. Force Interrupt. Terminate operation. 



Data to be written to the disk is transferred from the TRS-80 to the 
FD1771B-01 in parallel, 8 bits at a time. Data to be read from the disk is 
assembled from bit serial data from the disk into 8 bit bytes and then sent 
to the TRS-80 in parallel. In addition to serial/parallel conversion for 
data, the FD1771B-01 also recieves parallel data related to head 
positioning for the disk. All parallel data, whether commands or user 
data, is sent to the FD1771B-01 over the eight-bit data bus from the TRS- 
80 CPU, D7 through DO. Every time a byte of data is sent over the data 
bus, the disk controller must first be addressed by performing a "load 
instruction" for a read from the controller, or a "store instruction" for a 
write to the controller. Addressing and transfer of data to the disk 
controller vyiH be explained in more detail in the following two chapters. 

The FD1771B-01 contains several registers for positioning and disk 
data. They are shown in Figure 1. 
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Figure 1. The FD1771B-01 
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Power Supply Signals 

The FD1771B-01 requires +12 VDC, +5 VDC and -5 VDC. 

FD1771B-01 to Disk Signals 

The signals described under the SA400 are shown below, referenced 
to their FD1771B-01 signals. The FD1771B-01 signals perform the same 
functions as previously discussed. There is no chicken/egg debate here 
as the disk signals were defined before the controller; the controller is 
designed to easily implement the necessary logic for the disk. Pin 
numbers for both the SA400 and FD1771B-01 are provided in the table. 
Figure 2 shows a "pin-out" of the controller chip with all 40 pins of the 
controller chip and their corresponding signals. 



Tracks on the SA400 are numbered from (outermost) to 34 
(innermost). The track register is an 8-bit register which holds ihe 
current track number. Every time the disk head is stepped, the track 
register is automatically incremented or decremented to reflect the 
current track position. The track register may be read or loaded by a 
"load" or a "store" instruction in the Z 80. 

The sector register is an 8-bit register which holds the current sector 
number. As the ten sectors rotate under the head, the sector register is 
adjusted to hold the current sector number. The sector register may be 
read or loaded by a "load" or a "store" instruction in the Z-80. 

The command register is an 8-bit register which holds one of the 
eleven possible commands that may be issued to the FD1771B-01. The 
status register is an 8-bit register which holds status information from the 
disk. The status in the register varies with the command, but represents 
such typical conditions as "track 0", "disk busy" and "disk protected". 

An 8-bit data register holds data that is read from the disk or is to be 
written to the disk. This register interfaces to another data register, 
which converts the parallel TRS-80 data into serial form. 

Other logic in the FD1771B-01 is concerned with separating the data 
from the clock signal (data separator), arithmetic within the disk 
controller (arithmetic and logical unit), and control logic. 

Clock Signal 

The clock signal for the FD1771B-01 is a 1.0 mhz square wave input to 
the disk controller. The clock is used to control internal device timing 
and is also used to generate clock and data pulses sent to the disk for 
writes. 



FD1771B-01 Signal (pin) 

HLT (32) .^-- 

RDY/HLT (23) <-J- 

STEP (15) 

DIRC(16) 

WE (30) 

WD (31) 

FDDATA (27) 

WPRT (36) 

IP (35) 

TR00 (34) 




SA400 Signal (pin) 

from expansion interface 
STEP PULSE (20) 
DIRECTION SEL (18) 
WRITE GATE (24) 
WRITE DATA (22) 
READ DATA (30) 
WRITE PROTECT (28) 
INDEX PULSE (8) 
TRACK ZERO (26) 



A set of other signals for the FD1771B-01 are not used in the 
TRS-80 implementation. Examples of these are the factory test 
input (pin 22) and signals connected with an external data 
separator (pin 25). 



FD1771B-01 Signal (pin) 

HLD (28) 
3FM (18) 
TEST (22) 
XTDS (25) 



Description 

Head Load 

Three phase motor select 

Test input 

External data separator 
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FD1771B-01 Signal (pin) 
FDCLOCK (26) 

wi"(33) 
DINT (37) 



Description 

Floppy disc clock 
(external separator) 
Write fault 
Disc initialization 



Figure 2. FD1771B-01 Pin-Out 
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TRS-80 to FD1771B-01 Signals 

Both commands and data are passed between the TRS-80 and 
FD1771B-01 by DAL7' through DALO' (most significant to least 
significant). This is a bidirectional bus that feeds the data, sector, track, 
command, and status registers depending upon the command sent out 
by the TRS-80. The D AL7' through DALO' lines are connected (or gated) 
to the data bus to the TRS-80, 07 through DO, respectively. 
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Input signals RE' and WE' (pins 4 and 2) are read and write signals from 
the TRS-80. Each read and write operation to the FD1771B-01 transfers 
one byte of data, command, or status between the FD1771B-01 and Z-80 
or CPU. AO and Al (pins 5 and 6) interface directly to AO and Al of the 
TRS-80 and control which type of data transfer is to be made. If a read or 
write is performed to the FD1771B-01, the following actions take place, 
dependent upon the state of AO and Al. These transfers will be 
described in more detail later in this text. 



Al 



AO 



Read Action 



Write Action 



Read staus 
Read track 
Read sector 
Read data 



Write command 
Write track 
Write sector 
Write data 



Signal INTRQ (Interrupt Request) would normally be used to 
generate an interrupt in many computers, but in the Radio Shack 
implementation is used to signal a ready status to the TRS-80 by being 
tied to bus line D6. Signal INTRQ goes high at the end of any operation 
performed by the FD1771B-01 and is reset when a new command to the 
FD1771B-01 is issued. 

Signal MR' is "Master Reset" and is used to initialize the FD1771B-01 
to an initial condition. 

Another set of signals commonly used for interfacing are not 
connected or deactivated in this configuration. They are shown below: 

Signal (pin) Description 

DRQ (38) No connection. Data request. 

TG43 (29) Track greater than 43, no connection 

PH3 (17) Phase 3, no connection 

CS' (3) Chip Select. Ground. 



Commands 

Eleven commands may be sent to the FD1771B-01 by the TRS-80. 
They were previously listed. The first group of commands are related to 
motor positioning. They are Restore, Seek, Step-in, and Step-Out. All 
are sent to the FD1771B-01 by a write A0=0, A1=0 output. In the TRS-80, 
this would be accomplished by loading a CPU register with a byte 
defining the command value and performing a "store" instruction to 
address 37ECH. The 37ECH location is actually the disk address, and 
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the least significant two bits of the "C" are 00, which specifies the 
command register. Signal WE is active because a "store" instruction is 
being executed, and the write causes the command byte to be 
transferred from the CPU register to the command register in the 
FD1771B-01. 

Restore is issued by outputting a data byte of: 



O 



OIOO^OH Vi R 



The Restore moves the disk head to a position over track 0. There are 
three fields in the Restore command. The first field, H, may be a 1 or a 
in the TRS-80 system as it causes no action (the head is loaded at motor 
on). In other implementations it unloads or loads the head before a 
command. The second field is a verify field and may be a or a 1. It is 
used to verify that the track address read from the diskette is the same as 
the current track register contents. The third field (two bits) is used to 
vary the stepping rate of the head. The proper rate for TRS-80 operation 
with the SA400 is the stepping rate defined by binary 11. For discussion 
purposes, we will assume that the normal coding of these fields in the 
TRS-80 will be binary 0011. These three fields are also used in the other 
four commands in this group (Seek, Step, Step-in, and Step-Out) and we 
will assume a binary 0011 configuration here also. 

The Seek command must be preceded by an output to the data 
register to load the data register with the desired track number. (The 
output would be performed by a "store" to location 37EFH to store a 
track number in a CPU register.) When a Seek command is issued after 
the track number has been stored in the data register, the FD1771B-01 
will automatically position the head over the proper track by comparing 
the contents of the data register with the current track register and 
issuing an appropriate series of Step Pulses in the proper Direction. The 
Seek command format follows: 



7 O 

QioioiiioionTT 
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The Step command causes one step of the head to occur. The 
direction of the step, in or out, is the same as the previous Step 
command. The Step command does have an active field, U. The U field 
determines whether the track register is updated after the step. If U=l, 
the track register is incremented or decremented by one, dependent 
upon the direction of the step. If U=0, no adjustment is made. The Step 
format is: 



O 



OlOi l^UiOiOl lil 



The Step-in and Step-Out commands are similar to the Step, except 
that the direction is explicit. The U field operates as in the Step. 



O 



Step In 



Step Out 



O liOUiOiOmi 



OllUiUiOfQIlll 



To reiterate the commands in the first group then, Restore finds track 
0, Seek finds a specified track. Step, Step-in and Step-Out move one 
track. The Step commands have a field specifying whether the track 
register should be updated automatically. Generally this field will be set. 
The verify field may be optionally used on all commands to verify that the 
track # read from diskette matches that in the controller track register. 

The second group of the eleven commands in the FD1771B-01 are 
related to reading and writing data. There are two of these - Read 
Command and Write Command. 

User data is generally transferred a sector's worth at a time, or 256 
bytes. In general, data may be transferred under register I/O or Direct 
Memory Access (DMA) I/O. The latter operation allows an I/O device 
controller to transfer data between memory and the I/O device 
independentally of the CPU, and requires some fairly involved logic to 
sequence data transfer while "locking" out (suspending) CPU operation. 
DMA has the advantage of permitting the CPU to execute program 
instructions while the I/O transfers are taking place. The method used in 
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the TRS-80 is register I/O. This implementation works, but at the cost of 
CPU overhead. The CPU is continually "I/O bound" waiting in a "status 
loop" to transfer the next byte of data when the controller says it is ready 
(m this case the controller is the FD1771B-01). To "keep up with" the 
disk, the controller must be able to transfer one sector's worth in about 
one-tenth revolution, or 20 milliseconds, which is equivalent to 
transferring a byte every 78 microseconds. As normal instruction times 
are about 8 microseconds in the TRS-80, the Z-80 CPU can indeed keep 
up with data flowing from or to the disk. We will see the exact instruction 
sequence later in this book. 

Prior to the read or write, the TRS-80 program must load the sector « 
register with the sector number to be read or written. Also, of course 
the head must be positioned over the proper track by a Restore, Seek or 
series of Step commands. The sector register is loaded by a "store" 
instruction with an address of 37EEH (Al=l, A0=0) which stores a sector 
number from a CPU register into the FD1771B-01 sector register. The 
format of the Read and Write commands are shown below. As in the 
case of the positioning commands in the first group, the command is 
written to the FD1771B-01 command register by execution of a "store" 
instruction with an address of 37ECH (Al=0, A0=0). 

7 , O 

HQIOlMIBIEIOiOl Reac. 
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Write 



There are three fields in the Read command and four fields in the 
Write command. The M field in both is used to enable the read or write of 
multiple sectors or records." If M=0 a single record will be transferred If 
M-1 more than one sector will be transferred. The usual case for the 
1 KS-80 is to transfer only one sector, however, two to ten sectors could 
a^so be transferred by setting this bit. The B field of the Read or Write is 
always set to a 1 to signify IBM-compatible disk format, which is simply a 
de facto standard established by IBM. Field E controls a 10 millisecond 
delay which enables the head to engage before the read or write. As the 

tSthp^^ m-'M^''"^ ^^^T '^^ '"'"^ °^ ^"^^ f^°"^ "^°^°^ t"rn-on 

use thP 1^^, ' "* '^"^* r^^' '^' ^ ^'"'^ ^°">^ ^^ ^ °"^ or zero. We'll 
use the 10 millisecond delay only because Radio Shack uses it 

The Al/AO fields of the Write command control writing of the data 



address mark on the diskette. The standard IBM format for this is a 
hexadecimal FB, which is specified by a field of binary 00. 

Data is written or read to the diskette by continuously monitoring 
(reading) the status from the FD1771B-01. One of the status bits is DRQ, 
or Data Request, which signifies either that the data register contains the 
next byte of read data or has been 'emptied" of the last byte of write data. 
Examples of programming for reads and writes will be shown later. 

There are three commands in the next group, related to disk 
formatting. They are: Read Address, Read Track, and Write Track. As 
we mentioned previously, disk formatting initializes the diskette to a 
standardized (IBM) format with identification data for track and sector 
number, gaps between sectors, CRC (checksum) characters, and other 
data. Writing new data to the diskette is done in the 256-byte area 
reserved for user data. The complete format of the TRS-80 diskette is 
given in Appendix B. 

Read Address is a command that reads six identification bytes from 
the diskette from the next encountered identification field. Each time 
one of the bytes is read the DRQ (Data Request) bit is set in the status, so 
that the TRS-80 program can read it from the FD1771B-01 by a "load" 
37EFH instruction. The six bytes read are as follows: 

1. Track address, through 34 

2. Zeros 

3. Sector address, through 9 

4. Sector length 

5. CRC character 1 

6. CRC character 2 

These six bytes correspond to the bytes given in the appendix for 
track format. The Read Address command could be performed at any 
time, and not just during a formatting operation. The command for a 
Read Address is shown below: 

7 O 

IIIIOIOIOIIIOIO 



The Read Track command reads an entire track of the current 
diskette. Not only user data, but identification data is read as well. As in 
the case of Reading user data, the Data Request bit is used to indicate 
when the next byte of data is ready to be transferred from the 
FD1771B01 data register to the Z-80 CPU. Gaps on the diskette are also 
read and transferred. The Read Track command has one field, the S' 
field. If S'=0, the accumulation of bytes is synchronized to each address 
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mark encountered, so that the controller does not "get lost" in reading 
the track full of data. If S=l, no synchronization is done. The Read Track 
will primarily be done during the formatting process to verify formatting 
data, although it could be done at any time. The format of the Read 
Track is: 

7 O 

iiimoiolilol-l 



Write Track is used to format the diskette accoring to the format 
shown in Appendix B. Data in the given format is presented to the 
FD1771B-01 one byte at a time by the program. The Data Request bit is 
continually checked to see when the controller chip is ready for the next 
data byte. Address marks are written to the diskette by the controller 
chip upon detection of certain data patterns sent by the CPU. A CRC 
(cyclic redundancy check type of checksum) is written to the disk in the 
same fashion. The codes for these actions are: 



Pattern 


Description 


Clock Mark 


F7H 
FBH 
FCH 
FEH 


Write CRC 
Data Address Mark 
Index Address Mark 
ID Address Mark 


FFH 

C7H 

D7H (not used) 

C7H 



Obviously, no user data is written to the diskette during the Write 
Track operation. The user area is filled with E5H or some other 
nonconflicting pattern (the bytes above would generate a CRC or 
address action). The format of the Write Track is: 



Ililililohloln 



There is one command in the last group of eleven commands The 
Force Interrupt command is used to terminate the current command 
and to generate an "interrupt" in many systems. In the TRS-80 a Force 
interrupt command also causes an interrupt (if interrupts are 
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"enabled"). Termination of the current command and an interrupt occur 
when one of four conditions occur as specified in a four-bit field in the 
Force Interrupt command. 



o 



lIllOlllLILIl.li:! 



The four-bit field is defined by h, h, Ii, lo. Each specifies a 
different condition for the termination, as follows: 

Io=l, terminate on not ready to ready transition. 
Ii=l, terminate on ready to not ready transistion. 
I2=l, terminate on next index pulse. 
I3=l, immediate terminate/interrupt. 

If none of the above conditions is soecified, there is no interrupt but 
the command is terminated (Io=Ii=l2=l3=0). Why have so many 
conditions? Why not? It is even possible that all might be useful. For 
practical purposes however, probably only a Force Interrupt with no 
interrupt (binary 11010000) would be used, and that only to terminate a 
read or write of multiple sectors after the desired number of sectors. The 
FD1771B-01 is designed to cover many contingencies, but only a portion 
of all possible commands or conditions will be used in the typical 
microcomputer installation. 

Registers 

We have seen how the FD1771B-01 registers are used in the course of 
positioning and transfer of data. A recap of their use follows: 



Command Register Used to hold command to be acted upon. 
Command is written into the register from 
a CPU register. 

May be automatically updated with each 
Step. May be read by CPU. 
Setup with sector number prior to a read 



Track Register 
Sector Register 



or write. May be read by CPU. 
Data Register Used to hold data passing between the CPU 
and disk during reads and writes. Used 
, continuously as data is transferred one 
byte at a time. 
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The controller register not described above is the Status Register. The 
Status Register hold various status conditions during different 
operations. For a positioning command (Restore, Seek, Step, Step-in, 
Step-Out), the Status Register holds status as follows: 



765432 :o 



n 



L 



Busy 
.Index 
.Track 

.CRC Error 
.Seek Error 

_Head Engaged 

.Write Protect 



,Not Ready 



Not ready (bit 7) is always false (ready) when the disk is being 
addressed. Write protect (bit 6) indicates that the diskette write protect 
notch is covered. Head engaged (bit 5) is always true when a disk 
operation is being performed. Seek error and CRC error are active if 
verification was used. But 4 is set on track not found. Track (bit 2) is set 
when the head is over track 0. Index (bit 1) is true when the index mark is 
detected from the disk. Busy (bit 0) is set when a command is in process 
and reset when the command is completed. What status bits would 
normally be used in the TRS-80 for positioning commands? Certainly the 
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busy bit. The busy bit would be checked prior to issuing any new 
command to see if the controller was engaged in a previous activity. Any 
new action would be delayed until the busy bit was reset. Track might 
also be checked after issuing a Restore operation, to see that the Restore 
was successfully completed. 

During a Read or Write command, the status register holds status as 
follows: 



765432 lO 

I I I I I I I 



c 



BUSY 



.DRQ 



■ LOST DATA 



.CRC ERROR 



.RECORD NOT FOUND 



.RECORD TYPE (RD) OR 
WRITE FAULT 



.RECORD TYPE (RD) OR 
WRITE PROTECT 

.NOT READY 



For a Read or Write, the CRC refers to either identification data or to 
user data (status bit 3). This bit will be set to indicate invalid data. Lost 
data (bit 2) means that the CPU did not respond fast enough to keep up 
with the data being transferred between the CPU and disk. If this 
condition is true, the bit is set. This should never occur except in 
catastrophic cases. Record not found indicates that the desired track or 
sector or both was not found. This bit (4), would be set if this error 
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condition occurred (for example, loading an invalid sector number prior 
to the read). Data Request, DRQ bit 1, indicates that the buffer is empty 
on a write or full on a read. Busy (bit 0) is set during the time the Read or 
Write is active. Not Ready (bit 7) is always false (ready) when the disk is 
being addressed. On a Write, bit 6 is set for a write protect condition, 
while bit 5 indicates a write fault. On a Read these bits should be a 01 to 
indicate a 256 byte length. The chief bits used for status would be busy 
and DRQ. Busy would be tested by the program to insure that a previous 
operation was over. DRQ would continually be checked for the next 
data byte to be transferred. The other bits would be used to indicate fault 
conditions. 

Status is also available during the formatting type commands of Read 
Address, Read Track, and Write Track. The status bits would have the 
same meaning as in the other commands. Status during one of these 
three commands is as follows: 



Status Bit Read Address Read Track 



Write Tracl< 



7 


not ready 


not ready 


6 








5 








4 


ID not found 





3 


CRC error 





2 


lost address 


lost data 


1 


DRQ 


DRQ 





busy 


busy 



not ready 

write protect 

write fault 





lost data 

DRQ 

busy 

This chapter has discussed the operation of. the Western Digital 
FD1771B-01, primarily in terms of what internal operations are 
performed, and how it interfaces to the Shugart SA400 disk drive. The 
next chapter will show how the TRS-80 communicates to the 
FD1771B01 to enable the program to perform positioning operations 
and reads and writes. The last chapter will show the sequence of 
operations to perform in a program to accomplish.useful work with the 
disk. 
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Chapter 4 



Expansion Interface 



A schematic of the expansion interface as it pertains to the disk is 
shown in Figure 1. There are several sections to be considered in this 
Implementation. They are: 

1. Disk selection 

2. Motor on circuitry 

3. Addressing 

4. FD1771B-01 functions 

5. Interrupt circuitry 



Disk Addressing 

There are two general addresses associated with the disk(s). The 
address used to select the drive is37EXH, where X represents 1 through 
8. The 37E0H "device select" signal is decoded by two chips in the 
expansion interface, Z32, a dual 2-line to four-line decoder (74LS155) 
and Z43, a dual 2-line to four-line decoder (74LS139). These chips are 
also used to generate a "controller select" signal from address 37EXH, 
where X represents C, D, E, or F. 

Let's take a look at how these two select signals are generated. The 
outputs from Z43 are in two groups lYO, lYl, 1Y2 and 1Y3 and 2Y0, 
2Y1, 2Y2 and 2Y3. Each group is controlled by an enable signal Gl or 
G2. These enables must be low for any of the outputs to be active. If the 
enable is active then one of the outputs is active dependent upon the 
configuration of the select bits Al/Bl or A2/B2. The select bits define 
binary values 00, 01, 10, or 11 selecting YO, Yl, Y2 or Y3, in that order; 
the most significant bit is select bit B and the least significant is select bit 
A. With Gl low and select bits B1=0 and Al=l, for example, output lYl 
would be active, or low. Note that outputs lYl, 1Y2 and 1Y3 are not 
used in disk addressing. lYl is not connected, and the other two are 
used to denote input of a 32K or 48K address, respectively. 

Output lYO is fed back to the enable of the second decoder on the 
chip, G2. Now lYO is active, or low, when RAS* is low and A15 and A14 
are both zeros. RAS* comes from the CPU and is low when a memory 
request is made. The disk controller chip is "memory mapped" and 
addressed as a memory location, so RAS* will be low when we are 
addressing the controller chip or selecting a disk. Now with G2 low, the 
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outputs at 2Y0, 2Y1, 2Y2 and 2Y3 reflect the configuration of inputs B2 
and A2. 2Y1, 2Y2 and 2Y3 arc not used. 2Y0 will be active when A2 and 
B2 are both low. Since B2 is directly connected to All, All must be a 
zero for 2Y0. A2 is low when address lines A5, A6, A7, A8, A9, AlO, A12 
and A13 are true, causing the output of NAND gate Z42 to go' low. 
Output 2Y0 will be active (low) therefore, when the following conditions 



exist: 



ADDRESS BITS 



o 



15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 

o|o|i|i|o|i|i|i|i|i|i|x|x|xf7R1 



RAS*=0 



X-DONT CARE 



Output 2Y0 feeds chip Z32 enabling Gl and G2. This chip acts much 
the same as Z43, except that there are two additional enables, CI and 
C2. When Cl is high, then outputs lYO, lYl, 1Y2 and 1Y3 are enabled. 
When C2 is low, then outputs 2Y0, 2Y1, 2Y2 and 2Y3 are enabled. A 
common two select bits A and B determine which of the four outputs will 
be active. Now Cl and C2 are connected to two CPU signals RD* and 
WR*, respectively. These signals are active (low) when a read or write 
are being performed. The read and write are mutually exclusive, of 
course, and are used for addressing memory and I/O devices. When a 
read is being performed, signal RD* will be low and input Cl will be high 
(Z23 inverts the RD* signal) and one of four outputs lYO, lYl, 1Y2 or 
1Y3 will be active or low. When a write is being done, C2 will be low and 
one of the outputs 2Y0, 2Y1, 2Y2 or 2Y3 will be active or low. Now B and 
A, the two select signals, are directly connected to address lines A3 and 
A2. Bearing this in mind, the following table shows how the eight outputs 
of Z32 decode: 



Address Read 



37E0 
37E4 
37E8 
37EC 
37E0 
37E4 
37E8 
37EC 



Y 
Y 
Y 
Y 

N 
N 
N 
N 



rite Pin 


Signal 


lYO 


37E0 Read 


lYl 


no connection 


1Y2 


37E8 Read (printer) 


1Y3 


37EC Read 


2Y0 


37E0 Write 


2Y1 


CSW Cassette latch 


2Y2 


37E8 Write (printer) 


2Y3 


37EC Write 
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The table indicates the general address for activating each of 
the eight signals. In fact, since Al and AO are not used in generating the 
address select signals, each of the eight addresses above actually 
represents a block of four addresses. Address 37EC, for example 
represents addresses 37EC, 37ED, 37EE and 37EFH. The manner in 
which these address selects are used will be discussed below. 

Disk Selection 

Four signals are shown on Figure 1, and represent the disk select 
signals for disk drives 1, 2, 3 and 4. Only one of these signals should be 
active at any time. These signals are output from a four bit latch, Z36 
(74LS175). The address of this latch is 37E0H. When a write is done to 
address 37E0H, the four low-order bits on the data bus, D3 through DO, 
are clocked into the four bits of Z36 by the 37E0 write signal. Loading a 
register with 1, 2, 4 or 8, and performing a "store" to location 37E0H 
then, selects disk drive 1, 2, 3 or 4, respectively. 

Motor On Circuitry 

Whenever a disk drive is selected, the 37E0H signal also goes to chip 
Z29. Z29 is a "one-shot" which provides a short pulse for a 
predetermined period of time, in this case approximately 3 seconds. The 
pulse from Z29 is used to enable signal Motor On, which turns on the 
disk drive motor in preparation for disk activity. After three seconds or 
so, the motor will automatically turn off if no further 37E0 write is 
performed. Another related action performed by the 37E0 write is 
generation of a "ready" signal to the FD1771B-01. Inputs HLT and RDY 
are used by the FD1771B-01 to determine whether the head is loaded 
and the disk drive is ready for activity. In the TRS-80 implementation, 
these inputs are true only when one of the drives has been selected. If 
one drive has been selected, then one of the four latches in Z36 is set, and 
the corresponding "not Q" output is a zero, making the common 
HLT/RDY signal a high. This signal goes low when Z36 is cleared by Z29 
at the end of the delay. 



FD1771B-01 Functions 

The address of the FD1771B-01 is 37ECH, as explained above. 
Whenever a read or write is performed to memory address 37EC, data 
flows between the CPU and the FD1771B-01. The register within the 
FD1771B-01 that is being addressed is determined by address bits 1 and 
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These two address bits control the operation, as described undei 
'TRS-80 to FD1771B-01 Signals" in the previous chapter. To read statuj 
from the FD1771B-01, for example, a read to address 37EC would be 
performed. A write to the sector register would be accomplished by < 
write to address 37EEH (Al=l, A0=0). The read and write signals to th< 
FD1771B-01 are signals 37EC read and 37EC write from the decode: 
chip, which of course, are true for reads and writes in addresses 37EC 
through 37EFH. 

Data is sent between the FD1771B-01 and CPU along the data bus, D7 
through DO. Signal 37EC read is used to gate data from the controller to 
the CPU by enabling devices Z33 and Z38; signal 37EC write is used to 
gate data from the CPU to controller by enabling chips Z33 and Z37. 

Interrupt Circuitry 



At the completion of any FD1771B-01 operation, the controller 
generates an interrupt signal called INTRQ. In the TRS-80, this signal is 
gated onto the data bus by signal 37E0 read, along with the real time 
clock signal (INTRQ goes to D7 while RTC goes to D6). INTRQ also is 
routed to Z35 as one of two inputs that eventually set Z28 to generate an 
interrupt signal to the CPU. Since INTRQ is not only set to signal the end 
of a normal disk operation, but is also set to denote an unsuccessful disk 
operation, INTRQ could cause an interrupt in the CPU for abnormal 
conditions, providing that the interrupts were enabled (EI instruction 
executed). At this time of writing, not enough is known about the 
internal workings of TRSDOS to report on how disk interrupts are 
handled, if at all. Disk operations do not require interrupts, as we shall 
see in the next chapter, and for the time being we shall leave this 
question unresolved. 



Chapter 5 
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Disk Programming 



The rudimentary set of commands that can be used on the disk(s) in 
the TRS-80 are the commands described in chapter 3. No other basic 
disk operations are possible. At this level, then, the user can only 
perform a restore, seek, step head, read sector, write sector, read 
address, read track, write track and force interrupt. Normally the read 
address, read track, and write track are used only for formatting the 
diskette, so the general purpose commands are only restore, seek step 
head, read sector, write sector, and an infrequent force interrupt (which 
resets the controller). 

Just as Z-80 instructions may be combined to implement Level I or 
Level II Basic, rudimentary disk commands may be combined to 
implement a sophisticated disk operating system or disk file manager. 
Sequential or random access methods may be implemented, files may be 
defined in various types of directories, sorts and merges may be 
performed on records, and disk accesses may be optimized for access 
speed. It is beyond the scope of this text to describe the procedures for 
implementing a disk operating system or file manager, just as a text on Z- 
80 programming would not show the implementation of a Basic 
interpreter. What will be show however, are methods for performing 
individual operations such as restores and reads which may then be 
combined into user programs as building blocks for more advanced 
operations. 

Is it possible to perform disk operations using Basic? The answer is 
that the head positioning operations such as restore, steps and seeks 
may indeed by implemented using Basic, but that reads and writes may 
not. Reading and writing sectors (and tracks) are implemented in the 
TRS-80 under programmed I/O operations. Each individual byte of data 
transferred between the CPU and disk is handled in a CPU register. The 
program must continually test the disk status to see whether the disk is 
ready for the next data byte or whether the disk has the next data byte 
available. Since bytes become available at the rate of one every 64 
microseconds or so, the program must be fast enough to keep pace with 
this data rate. Fast loops within a Basic program might require 3 
milliseconds, which is many times slower than the speed required to 
keep pace with reads and writes. Read or write operations then must be 
performed under assembly language software routines. 
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Head Positioning 



To become familiar with the sequence of operations for disk functions, 
let's look at some Basic head positioning routines. These routines may 
be converted to assembly language routines quite simply, or left as Basic 
routines. 

First of all we will do a simple write to address 37E0H. This opeation 
should select a drive and turn on the disk drive motor for about three 
seconds. 



POKE 14304,0 



37E0H address 



The above command stores a zero value in the four bits of Z36, selecting 
no drive, and simultaneously turns the motor of the dirve on for about 
three seconds. A value other than zero could be used to select the drive; 
a 1, 2, 4 or 8 would select drive 0, 1, 2 or 3 respectively. The only effect of 
the select would be to bring down the select line for the appropriate 
drive. 

Now put a protected diskette in the drive. The following routine will 
select drive 1 and then read the status from the drive. As long as the drive 
IS selected (the select bits are cleared when Z29 and the motor goes off), 
we will get back status from drive 1. The status should tell us that the 
diskette is protected (see chapter 3), and should also tell us if sector 
has just passed the index pulse detector. Since sector zero comes 
around every 200 milliseconds or so, we'll not see the sector zero status 
every time due to the timing of the Basic loop and the short "window" for 
sector 0. When the drive is "deselected" after three seconds, a status of 
128 will be printed, indicating a "not ready" conditicfn. Status during the 
selected time will be 68 or 64, indicating write protect and possibly that 
the head is over track zero. 



100 
200 
250 
300 
400 



POKE 14304,1 

A=PEEK(14316) 

IF (A AND 2)=2 PRINT'SECTOR 0)" 

PRINT A 

GOTO 200 



select 

get status 

test sector 

print 

loop on status 



Now take off the protect label or put an unprotected diskette in the 
drive and repeat the above program. Status during the select time 
should indicate disk not protected (0 or 4). 

Now we will try a more advanced operation. The following program 
selects the drive, does a restore to move the head to track 0, reads back 
the track register and prints the value (should be zero), steps in the head 
one track, reads the track register and prints it (should be 1), and loops 
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back to the track register read. The command in 200 does a restore at a 
slow stepping rate and the command in 600 does a step-in with automatic 
update and slow stepping rate. The status check at 300 and 400 tests to 
see whether the disk is busy or whether it is done performing the restore. 
This busy check will be found on virtually every command. Value 14317 
addresses the track register in the PEEK (a read). 

100 POKE 14304,1 select 

200 POKE 14316,3 restore 

, 300 A=PEEK(14316) get status 

400 IF (A AND 1)< >0 GOTO 300 test busy 

500 A=PEEK(14317) get track register 

550 PRINT A print 

570 FOR I =0 TO 300:NEXT wait for display 

600 POKE 14316,83 step-in 

700 A=PEEK(14317) get track register 

800 PRINT A print 

900 GOTO 700 loop 

In the above program the FD1771B-01 automatically incremented the 
track register when the step-in was performed. Unless the update bit is 
specified, that update will not be done. The following program steps in 
from track after a restore and prints the track register each time. A 
delay is put in at 760 for display purposes. 



100 POKE 14304,1 

200 POKE 14316,3 

300 A=PEEK(14316) 

400 IF (A AND 1)<> GOTO 300 

500 A=PEEK(14317) 

550 PRINT A 

570 FOR I=0 TO 300:NEXT 

600 POKE 14304,1 

610 POKE 14316,83 

700 A=PEEK(14316) 

750 IF (A AND 1)< >0 GOTO 700 

760 FOR 1=0 TO 300:NEXT 

770 A=PEEK(14317) 

800 PRINT A 

900 IF A < 35 GOTO 600 



select 

restore command 

get status 

test busy 

get track register 

print 

delay for display 

select 

step-in 

get status 

test busy 

delay for display 

get track register 

print 

keep on steppin' 



To observe what happens when the update bit is not set in the step-in 
:ommand, substitute a 67 for the 83 in 610. Don't let this continue too 
ong, however, as some types of drives have been known to step off the 
!nd of the earth (or at least the step mechanism); a few steps are fine 
lowever, and will illustrate the update of the track. 
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The stepping rate used for the SA400 is 40 milliseconds, specified by a 
binary 11 in the step rate field in the positioning commands. This is the 
rate that should be used normally. For illustration of this field's use 
however, the following program may be used to step in at a faster rate. 
Use 80 for a fast rate and 83 for a slow rate in line 610. 



100 POKE 14304,1 

200 POKE 14316,3 

300 A=PEEK(14316) 

400 IF (A AND 1) < > GOTO 300 

..600 POKE 14304,1 

6a0 POKE 14316,80 

700 B=PEEK(14316) 

770 A=PEEK(14317) 

800 PRINT A 

900 IFB < 35 GOTO 600 



select 
restore 
get status 
test busy 
select 
step-in 
get status 
get track 
print 
loop 



The above programs have used a step in command. Let's use the step 
out command and clean up some of the code. The following program 
uses subroutine 1000 as a busy check. A return is made only when the 
previous command is done. Subroutine 2000 performs an operation 
determined by V, waits for done, and then prints the track register. The 
program steps into track 35 and then steps out to track 0. 



select 

restore 

test done 

step-in 

output and test 

step in till end 

step-out 

output and test 

step out till end 

done 

get status 

go if busy 

return 

select 

output command 

test done 

get track register 

print 

return 



100 


POKE 14304,1 


200 


POKE 14316,3 


300 


GOSUB 1000 


400 


V=83 


500 


GOSUB 2000 


600 


IF A < 35 GOTO 500 


700 


V=115 


800 


GOSUB 2000 


900 


IF A <>0* GOTO 800 


950 


END 


1000 


A=PEEK(14316) 


1100 


IF (A AND 1) <>0 GOTO 1000 


1200 


RETURN 


2000 


POKE 14304,1 


2050 


POKE 14316,V 


2100 


GOSUB 1000 


2200 


A=PEEK{14317) 


2300 


PRINT A 


2400 


RETURN 



37 

One question the reader may be asking - why select each time a step is 
done? Don't forget that the motor stays on only for about three seconds. 
If the entire disk operation takes longer than that, the drive is 
automatically deselected. It is a good idea therefore, to select before 
each new disk operation (command) to keep the disk in a ready 
condition. This applies not only to Basic code, but to assembly language 
code as well. 

We have seen the step in and step out command used. Now let us use 
he step from last direction. As you will recall, this command will cause 
he FD1771B-01 to step in the same direction as the previous command. 



100 POKE 14304,1 

200 POKE 14316,3 

300 GOSUB 1000 

400 POKE 14316,83 

500 GOSUB 1000 

600 FOR 1=1 TO 34 

650 POKE 14304,1 

700 POKE 14316,51 

800 GOSUB 1000 

850 A=PEEK(14317) 

860 PRINT A 

900 NEXT 

950 END 

1000 A=PEEK(14316) 

1100 IF(AAND1)< >0 GOTO 1000 

1200 RETURN 



select 

restore 

test done 

step-in 

test done 

setup loop 

select 

step from last dir. 

test done 

get track 

print 

loop 

done 

get status 

test done 

return 



The only other positioning command we have not used is seek. The 
following program seeks from any input value. Obviously valid values are 
through 34 for the track. The seek assumes that the data register of the 
FD1771B-01 has been loaded with the value representing the desired 
track. This is done at 500. When the seek command is executed at 700 
the FD1771B-01 automatically steps in or out to position the head over 
the desired track. The track register must of course, have the correct 
current track number for a proper seek. 



100 POKE 14304,1 

200 POKE 14316,3 

300 GOSUB 2000 

350 INPUT V 

400 POKE 14304,1 

500 POKE 14319,V 



select 
restore 
test done 
input track # 
select 
output track # 



38 



600 GOSUB 2000 

700 POKE 14316,19 

800 GOSUB 2000 

900 A=PEEK(14317) 

1000 PRINT A 

1050 A=PEEK(14316) 

1060 PRINT A 

1100 GOTO 350 

2000 A=PEEK(14316) 

2100 IF(AAND l)<>0GOTO2000 

2200 RETURN 



test done 

seek command 

test done 

get track 

print 

get status 

print 

loop on input 

get status 

test done 

return if done 



The above routines illustrate the use of the positioning commands. 
Assembly language implementation would follow the above approaches 
(we shall see assembly language routines later in this chapter). The 
important thing in the use of the positioning commands is to know where 
you are. The reference point is track zero to which the head may always 
be positioned. Although the FD1771B-01 should not fail to update the 
track register properly, that gaelic law applies. 

Reading/Writing 
To illustrate reading and writing of sectors, we will use code from a 
popular microcomputer. The code is unsophisticated and can be 
accessed using a symbolic disassembler such as Small Systems 
Software's RSM-IS. 

One of the first things that Level II Basic does is to test whether a disk 
is present. If a disk is present, then Level II assumes that a program is 
present on sector 0, track 0, and reads that program in. The program, of 
course, is a portion of TRSDOS. The process of reading in the program 
is called "bootstrapping" or "booting in", and is a way for the system to 
pull itself up by it's own bootstraps after power up or RESET. If a disk is 
not present, of course, or if BREAK is pressed on power up, Level II goes 
instead to Level II Basic, bypassing the disk. 

If we examine the first three instructions in Level II Basic we find: 

0000 F3 DI disable interrupts 

0001 AF XOR A OtoA 

0002 C3 74 06 JP 0674 jump to loc 0674H 

This sequence is always entered on power up, as a power up causes 
execution to start at location 0. The first instruction disables all external 
interrupts except for the non-maskable interrupt. The A register is 
loaded with and a jump is then made to loaction 0674H. 

At location 0674H we find the "disk boot" routine shown below in 
figure 1. The disk boot starts at 0696H after other initialization. The disk 
boot performs the following functions: 
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1. Read disk status (0696H) 

2. Test for status bits from disk (069 AH) 

3. If no status for disk, go to location 0075H (069CH) 

4. Else: Select drive 1 by outputting 1 to select latch address 37E1H 
(06A1H). 

5. Send restore command (3) to disk command register (address 
37EC - 06AAH). 

6. Delay 65536 counts (0060 is a subroutine to delay by count in BC 
register pair). This is done to let the motor come up to speed and for 
head movement. 

7. Test busy bit for status (06B2H). 

8. Loop to 7 if busy. 

9. Else: Send to sector register by outputting to location 37EEH. 
This prepares the disk to read sector of track 0. 

10. Send 8CH read command by outputting 8C to location 37EC 
(06BFH). Read sector 0, track 0, byte 0. 

11. Test bit 1 of the status register (DRQ). If DRQ is not zero, the 
next byte of data is not present in the FD1771B-01 data register and step 
1 1 is again executed. Else: Data is present and the data is read into the A 
register (06C4H) and transferred to the 4200H area (06C5H). 

12. The BC pointer is bumped by one (06C4H) to point to the next 
destination in the 4200 area (06C6H). 

13. If C=0, steps 11 through 13 are repeated to transfer 256 bytes of 
data from sector to 4200H through 42FFH. 

14. A jump is made to TRSDOS start at 4200H (actually a TRSDOS 
loader). 

Note that in the above routine all I/O is done on a "programmed I/O" 
basis. Reading a byte of data is done by checkding the DRQ bit to see if a 
new byte of data has been assembled from the serial bit stream. If so, a 
byte is read into A and then transferred to the 4200H area (200H bytes 
above the start of RAM. The read resets the DRQ bit and the process is 
repeated 256 times to read the sector of data. 

This simple bootstrap is a common brute force approach to initializing 
a system. No checks are made on the validity of the data in this routine, 
but chances are good the operation will go off without a hitch. If not, 
another power up will repeat the entire process. 

If a RESET is performed, the same test for disk present is made at 
location 66H and a jump made to location OOOOH if the disk is there, 
where a transfer to the bootstrap.routine is made. 

0066 31 00 06 LD SP,0600 reset 

0069 3A EC 37 LD A,(37EC) get status 

006C 3C INC A 

006D FE02 CP 02 test for disk statu.s 

006F D2 00 00 JP NC,0000 go if disk is there 
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The read command in the above code is an 8CH. As previously 
described, the read fields should be set for a single sector (bit 4=0, IBM 
format (bit 3=1), and enable head load and 10 millisecond delay (bit 2=1). 
This command code should always be used, with the exception of 
reading multiple sectors. Note also in the above code that it does take 
time for the motor to get up to speed (less than a second) and that this 
should be a time-out in the program. Continuing disk operations should 
always perform a select to keep the motor on. 





F 


igure 1. 


Disk Bootstrap Routine 


0696 


3AEC37 


LD 


A,(37ECH) 


;GET DISK STATUS 


0699 


3C 


INC 


A 




069A 


FE02 


CP 


02 




069C 


DA7500 


JP 


C,0075H 


;G0 IF NO DISK 


Q69F 


3E01 


LD 


A,01 


;FOR DRIVE 1 


06A1 


32E137 


LD 


(37E1H),A 


;SELECT DRIVE 1 


06A4 


21EC37 


LD 


HL,37ECH 


;1771 ADDRESS CMDS 


06A7 


11EF37 


LD 


DE,37EFH 


;DATA REG ADDRESS 


06AA 


3603 


LD 


(HL),03 


; RESTORE COMMAND 


06 AC 


010000 


LD 


BC,0 


; DELAY 64K COUNTS 


06AF 


CD6000 


CALL 


0060H 




06B2 


CB46 L00P1 


BIT 


0,(HL) 


;TEST BUSY 


06B4 


20FC 


JR 


NZ,L00P1 


;G0 IF STILL BUSY 


C6B6 


AF 


XOR 


A 


;ZERO TO A 


0687 


32EE37 


LD 


(37EEH),A 


;0 TO SECTOR REG 


G6BA 


010042 


LD 


BC,4200H 




06BD 


3E8C 


LD 


A,8CH 


;READ COMMAND 


06BF 


77 


LD 


(HL),A 


;READ SECTOR 


06C0 


CB4E L00P2 


BIT 


1,(HL) 


;TEST DRQ 


06C2 


28FC 


JR 


Z,L00P2 


;G0 IF DATA NOT AVAIL. 


06C4 


1A 


LD 


A,(DE) 


;GET NEXT BYTE 


06C5 


02 


LD 


(BO, A 


;TRANSFER DATA 


06C6 


OC 


INC 


C 


;BUMP BUFFER POINTER 


06C7 


20F7 


JR 


NZ,L00P2 


;G0 IF NOT 256 BYTES 


06C9 


C30042 


JP 


4200H 


;TRANSFER TO DOS LOADER 



Figure 2 shows the busy loop of another read. This read tests the 
DRQ as the previous one, but prior to the test of DRQ also tests the busy 
bit. The busy bit will be reset when the read operation is completed. For 
a single sector this will be after 256 bytes, while for multiple sectors this 
will be at the end of the track. If the busy bit is set, the next byte of data is 
obtained and stored away. If the busy bit is not set, a final status check is 
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made and the value of 5C is used to test for type, not found, CRC or lost 
data status. Any of these bits means that an error condition exists and 
the read was terminated improperly. In this case a force interrupt is used 
to reset the controller before either return is made. The type bit means 
that a data address mark other than FB or F9 was encountered, not 
found indicates track and sector were not found, CRC indicates invalid 
data, and lost data means that the CPU did not respond to the next byte 
of data. 



Figure 2. Generalized Disk Read 
(At start, (HL)=37ECH and (BC)=buffcr pointer) 



ir2C6 
52C9 
S2CA 
5'2CB 
5^2CD 
?2CE 
i-2D0 
r2Dl 

?2D5 
52D6 
?2D7 
5:2D8 
?2DA 
52 DB 
52DD 
o2DE 
52E0 



11EF37 

C5 

CI 

180B 

OF 

300A 

7E 

CB4F 

28F8 

1A 

02 

03 

18F6 

7E 

E65C 

C8 

36D0 

C9 



LD DE,37EFH ;DATA REGISTER ADDRESS 

PUSH BC ;WASTE TIME 

POP BC ;...AND SOME MORE 

JR 52D8H ;START READ 

BSYTS RRCA ;BUSY BIT TO C 

JR NC,52DAH ;60 IF NOT BUSY 

LOOP LD A,(HL) ;GET STATUS 

BIT 1,A ;TEST DRQ 

JR Z,BSYTS ;G0 IF NO DATA 

LD A,(DE) ;GET ONE BYTE 

LD (BC),A ;STORE IN BUFFER 

INC BC ;BUMP BUFFER POINTER 

JR LOOP ;LOOP FOR NEXT BYTE 

LD A^CHL) ;GET STATUS 

AND 5CH ;TEST TYPE^NFND^CRC^LOST 

RET Z ;G0 IF NO ERRORS 

LD (HL),ODOH ; FORCE INT (RESET) 

RET ; RETURN 



At this point it may be wise to talk about some of the idiosyncracies of 
the TRS-80 disk implementation. Although nothing is mentioned in the 
FD1771B-01 documentation, code in the Radio Shack system uses "time 
wasting instructions" after certain disk I/O commands. Evidentally some 
settling time is required after execution of FD1771B-01 commands. This 
IS a type of thing usually found out after debugging, and may reflect specs 
not stated in FD1771B-01 documentation, system design problems, or 
code put in "just to play it safe". A sequence such as: 

PUSH AF 

POP AF 

PUSH AF 

POP AF 
is typically used after a seek command. These instructions are 
essentially no operations and prevent another command from directly 
following an initial disk command. Additional time wasters may be 
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required after steps, or read or write commands. Another problem 
associated with the TRS-80 system is that some of the code associated 
with the disk is presumably deliberately vague. Therefore, do not be too 
surprised to find confusing routines or structure while disassembling or 
investigating parts of TRSDOS. 

The operations for disk sector writes is handled much the same way as 
a read, except that the data register is now loaded with a data byte, and 
then the DRQ is checked to determine if the controller is ready for the 
next data byte. In the routine in figure 3, the busy bit is check as 
previously; it signifies the end of the write. After the write has been 
completed, the same status bits are checked. Bit 6 in the write case 
signifies write protect instead of record type as in the case of read. 

Figure 3. Generalized Disk Write 

(BC contains buffer pointer) 

(HL contains status, comnnand address 37EC) 



;GET STATUS 

;BUSY BIT TO C 

;G0 IF BUSY 

;WRITE COMMAND 

;DATA REG ADDRESS 

;WASTE TIME 

;...AND SOME MORE 

;...MORE YET 

;...DONE WASTIN' TIME 

;BYPASS BUSY CHECK 

;BUSY TO C 

;G0 IF NOT BUSY 

;GET STATUS 

;TEST DRQ 

;G0 IF NEW DATA NOT RE( 

;GET NEXT DATA BYTE 

; OUTPUT TO DATA REG 

;BUMP BUFFER POINTER 

; CONTINUE 

;GET STATUS 

;TEST W PRO^ N FND, CRC 

; LOST 

;OUTPUT FORCE INT (RESE 

; RETURN 
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FE61 7E 


SLOOP 


LD 


A^CHL) 


FE62 OF 




RRCA 




FE63 DA61FE 




JP 


C, SLOOP 


FE66 36A8 




LD 


(HL),0A8H 


FE68 11EF37 




LD 


DE,37EFH 


FE6B C5 




PUSH 


BC 


FE6C C1 




POP 


BC 


FE6D C5 




PUSH 


BC 


FE6E C1 




POP 


BC 


FE6F C376FE 




JP 


DRQCK 


FE72 OF 


BSYCK 


RRCA 




FE73 D282FE 




JP 


NC^DONE 


FE76 7E 


DRQCK 


LD 


A^(HL) 


FE77 CB4F 




BIT 


1/A 


FE79 CA72FE 




JP 


Z^BSYCK 


FE7C OA 




.LD 


A^CBC) 


FE7D 12 




LD 


(DE),A 


FE7E 03 




INC 


BC 


FE7F C376FE 




JP 


DRQCK 


FE82 7E 


DONE 


LD 


A^(HL) 


FE83 E65C 




AND 


5CH 


FE85 C8 




RET 


Z 


FE86 36D0 




LD 


(HD^ODOH 


FE88 C9 




RET 





Formatting 

Formatting a diskette can be performed by one of two methods. The 
TRS-80 software contains a disk formatting program that automatically 
formats a diskette to "standard" format as defined in Appendix B. 
User-formatted diskettes, on the other hand, do not contain any 
directories or applications programs and cannot be used by TRSDOS. A 
user-formatted disk, of course, can be used for any user file management 
software which operates independently of TRSDOS. 

If the user wishes to format a diskette, he may do so by constructing a 
track's worth of data arranged in the proper format and then executing a 
write track command. The implementation of the write track will be 
almost identical to a write sector sequence, except that an entire track is 
written. 

If the user wishes to read a track, the read track command can be 
implemented in the same fashion as read sector. In this case however, 
the entire track will have to be read into a large buffer before the busy bit 
is reset. All data on the track including gaps, data marks, and data is read 
in, so this is a convenient way (though laborious) of investigating data on 
any diskette track. A program to read any given track is shown below in 
figure 4 (track number in location 5043). 

The read address command operates similarly to a read sector except 
that the six data bytes of an ID field are read from a track. The read 
address would primarily be used for verification of a formatting 
operation. 



Figure 4. Read Track Program 



5000 

5001 

5003 

5006 

5009 

500A 

500D 

500E 

5011 

5014 

5017 

501 A 

501 D 

501 F 

5020 

5021 

5022 



F3 

3E01 

32E137 

210000 

2D 

C20950 

25 

C20D50 

32E137 

3A4350 

32EF37 

21EC37 

361 B 

F5 

F1 

F5 

F1 



L00P1 



L00P2 



DI 


^ 


LD 


A^OI 


LD 


(37E1H),A 


LD 


HL,0 


DEC 


L 


JP 


NZ,L00P1 


DEC 


H 


JP 


NZ,L00P2 


LD 


(37E1H),A 


LD 


A, (TRACK) 


LD 


(37EFH)^A 


LD 


HL,37ECH 


LD 


(HL),1BH 


PUSH 


AF 


POP 


AF 


PUSH 


AF 


POP 


AF 



/DISABLE INTERRUPTS 
;FOR SELECT 
;SELECT DRIVE 1 
; DELAY COUNT 



;SELECT AGAIN 
;LOAD TRACK # 
;OUTPUT TO DATA REG 
; STATUS, CMD ADDRESS 
;SEEK COMMAND 
;WASTE TIME 
;NOTE: DRIVE SELECT 
; POSITIONS TRACK TO 
;0, RESETS TRACK REG 
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5023 7E 


LD 


A,(HL) 


;GET STATUS 


5024 OF 


RRCA 




;BUST TO C 


5025 DA2350 


JP 


C,5023H 


;L00P IF BUSY 


5028 010060 


LD 


BC,6000H 


;BUFFER AREA 


502B 36E4 


LD 


(HL),0E4H 


;READ TRACK COMMAND 


502D C5 


PUSH 


BC 


; WASTE TIME 


502E C1 


POP 


BC 


;...AND SOME 


502F C5 


PUSH 


BC 


;...MORE YET 


5030 C1 


POP 


BC 


;...DONE WASTIN' TIME 


5031 7E L00P3 


LD 


A,(HL) 


;GET STATUS 


5032 OF 


RRCA 




;BUSY TO C 


5033 D20342 


JP 


NC,4203H 


; RETURN TO MONITOR 


5036 CB47 


BIT 


0,A 


; ON DONE 


5038 CA3150 


JP 


Z^L00P3 


;LOOP IF NOT DATA 


503B 3AEF37 


LD 


A,(37EFH) 


;READ DATA 


503E 02 


LD 


(BC),A 


; STORE IN BUFFER 


503F 03 


INC 


BC 


;BUMP BUFFER POINTER 


5040 C33150 


JP 


L00P3 


;RTN FOR NEXT BYTE 


5043 00 TRACK 


DEFB 





;TRACK # 



Conclusion 

While the above examples do not constitute a complete description of 
every disk operation, it is hoped that they will provide the reader with the 
basic knowledge to write his own assembly language software routines 
for the disk if he desires. By bypassing TRSDOS it is possible to optimize 
disk storage space and access times, and to create whatever file 
management or disk operating system softweare the user requires, 
subject to his time and patience. 
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FD1771B-01 Commands for TRS-80 i 


: TYPE 


COMMAND 


BINARY 


HEX* 


FLAGS : 


i I 


Restore 


OOOOOVll 


03 


V: no verify, 1 verify ! 


: I 


Seek 


OOOlOVll 


13 


V: no verify, 1 verify ! 


I 1 


Step 


OOlUOVll 


33 


V: no verify, 1 verify ; 

U: no update, 1 update j 

track register j 


1 I 


Step In 


OlOUOVll 


53 


V: no verify, 1 verify \ 

U: no update, 1 update ; 

track register j 


i I 


Step Out 


OUUOVll 


73 


V: no verify, 1 verity ; 

U: no update, 1 update j 

track register ■ 


1 II 


Read 


lOOMllOO 


8C 


M: single sector, ; 
1 multiple I 


1 " 


Write 


lOlMUOO 


AC 


M: single sector, ■ 
1 multiple ; 


: m 


Read Address 


IIOOOIOO 


C4 




I "I 


Read Track 


IIIOOIOS 


E4 


S: synchronize to J 
address mark, 1 no • 
synchronize I 


: III 


Write Track 


11110100 


F4 




1 IV 


Force Inter- 
rupt 


11010000 


DO 




^■■■■■■■■a.a 








* Usual value used. • 
•>■■■..■■......■■■■■•■■■■•■# 
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Status 



■ 

Bit 


Typel 


Read 


Write 


Read 
Address 


Read 
Track 


Write 
Track 


7 


Not 


Not 


Not 


Not 


Not 


Not 




Ready 


Ready 


Ready 


Ready 


Ready 


Ready 


6 


Write 


Record 


Write 








Write 




protect 


type 


protect 






protect 


5 


Head 


Record 


Write 








Write 




engag'd 


type 


fault 








fault 


4 


Seek 


Record not 


Record not 


ID not 










error 


found 


found 


found 






3 


CRC 


CRC 


CRC 


CRC 










error 


error 


error 


error 






2 


Track 


Lost data 


Lost data 


Lost data 


Lost data 


Lost data 


1 


Index 


DRQ 


DRQ 


DRQ 


DRQ 


DRQ 





Busy 


Busy 

■■■■■■■■haaaa 


Busy 


Busy 


Busy 

»■■■■■■■■■■ 


Busy 

1 
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Disc Format for TRS-80 3 * 
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WRITING 



READING 





# 


Pattern Description 


# Pattern Description 


Precedes 










First Sector_ 


18 


FF Filler 


1 18 FF 


Filler 




1 


FE ID address mark 


: 1 FE 


ID address mark 




1 


XX Track # (0-9) 


■ 1 XX 


Track # 




1 


00 


; 1 00 






1 


xx2 Sector # (0-9) 


: 1 xx2 


Sector # 


First 


1 


01 


: 1 01 




Sector 


1 


F7' Generates 2 CRC bytes 


I 2 XX 


CRC chars (ID) 




12 


FF Filler 


1 12 FF 


Filler 




6 


00 Filler 


: 6 00 


Filler 




1 


FB Data address mark 


: 1 FB 


Data addr. mark 




256 


E5 For user data area 


:256 E5 


Dummy user area 




1 


F7» Generates 2 CRC bytes 


! 2 XX 


CRC chars (data) 




12 


FF Filler 


: 12 FF 


Filler 




,-..§. 


..PP.fJllfJ. 


■ 6 00 


Filler 


Physical 








Sectors 


Repeat sector data 8 more times 


' 8 more sectors read 


2-9 












1 


FE 


: 1 FE 






1 


XX 


! 1 XX 






1 


00 


: 1 00 






1 


xx^ 


1 1 XX2 




Last 


1 


01 Same as above 


; 1 01 


Same as above 


Sector 


1 


F7' 


; 2 XX 






12 


FF ! 


! 12 FF 


. 




6 


00 : 


6 00 






1 


FB ; 


1 FB 






256 


E5 ; 


256 E5 






1 


F7' : 


2 XX 






1065 


FF Write until not busy ■ 


106= FF 


Read 'til not busy 



NOTES: 

' F7 character generates two CRC check characters in hardware. 

2 Physical sector numbers on diskette go in this orden 0, 5, 1, 6, 2, 7, 3, 8, 4, 9 (I.e. 
third sector of track is 1) 

3 Above defines one track. 

" Above defines track without files. Data files are rewritten for 256 data bytes per 

sector. 

5 Approximate number of bytes before controller terminates operation. 
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Appendix C 



DISKIO 
Description 

DISKIO is an assembly language program that is used to read and 
write data from one to four disks in a TRS-80 program. A software 
routine such as this is commonly called a "driver" and DISKIO is 
essentially a "disk I/O driver". The user may call DISKIO from another 
assembly language program, or from a Basic program using the USR 
function. DISKIO is oriented towards reads and writes of single sectors 
or tracks, but also provides the capability of head positioning, status 
check, or address read. DISKIO is entirely relocatable. That is, the 
machine language code from "DISKIO" to "end" may be moved bodily 
anywhere in memory without reassembly or modification of instruction 
address fields. Alternatively, of course, the routine may be reassembled 
at any convenient origin. 

Calling Sequence 

DISKIO is called by loading the index register IX with the address of a 
parameter block and by performing a CALL to DISKIO. Return is made 
to the location immediately following the CALL. 

(IX) = parameter block pointer 

CALL DISKIO 

(return) 

The paramter block consists of eight bytes, specifying eight parameters 
for the DISKIO routine. 

The first byte contains a function code of through 6. Functions are: 

Read status 

1 Position head over given track 

2 Read sector specified into buffer 

3 Write sector specified from buffer 

4 Read address (ID) data from given track 

5 Read entire specified track 

6 Write entire specified track 

Byte 1 contains a sector number from to 9 for functions 2 and 3 (read 
and write sector). 

Byte 2 contains a track number from through 34 for all functions 
except the read status function. 

Bytes 3 and 4 contain a 16 bit address for functions 2 through 6. This 
address is the address of the data source for writing to the disk, or the 
data destination for reading /rom the disk. Note that the Z-80 uses the 
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low-order 8 bits in the first byte and the high-order 8 bits in the next byte. 
The assembler takes care of this automatically, and this information is 
meant for those users who may be "patching" machine code. 
Byte 5 is not set up by the user, but does contain a "type of completion" 
after DISKIO has returned to the calling code. Upon return, a OIH value 
specifies that the function was performed without error. An FEH value 
((-2) specifies that one of the calling paramaters was invalid - sector #, 
track #, function # or drive #. An FFH(-l) specifies that an error occurred 
duVing the disk operation. The status code (byte 6) may be checked to 
determine the type of error in this case. An FDH (-3) specifies that a 
position error occurred. The position error may have been prior to the 
main function, as in the case of functions 2 through 6, or a result of the 
position head function itself. In either case, the status byte (6) will show 
the nature of the error. 

Byte 6 is not set up by the user and contains the status after the I/O 
operation has been performed. Status will be present after a successful 
I/O operation or in the case of an FFH or FDH type completion. Status is 
as follows: 

Bit Description 



None 

Write protect (functions 1, 3, 6) 

Write fault (functions 3, 6) 

Seek error (1), ID not found (4), 

record not found (2, 3) 

CRC (checksum) error (functions 1 - 4) 

Track (function 1), lost data (others) 

Index mark (function 1) 

None 




Status for an FDH type of completion will be identical to that returned 
for function I. 

Byte 7 has two fields. Bit 7 is a user-specified "wait" bit. If the W bit is a 
one, DISKIO will wait approximately 1 second for the disk motor to 
come up to speed before performing the disk operation. If the W bit is a 
zero, the operation will be performed immediately without a wait. The W 
bit must be set for the first disk operation. It need not be set for 
subsequent operations provided that these operations occur less than 
two seconds apart. The reason for this constraint is that each disk select 
(address) sets the motor on signal for about three seconds. After this 
three second period the motor turns off again, unless there has been a 
new select in the three second period. Use the wait option for initial disk 
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operations and for those operations that do not occur within two 
seconds of the last disk I/O. 

The second field in byte 7 is the drive number (0 through 3). Drive 
corresponds to Radio Shack drive # 1, and so forth. 



Functions 



Function 0, read status, reads back the current status from the specified 

disk. Drive number must be specified. 

Function 1, position head, positions the disk head over the specified 

track (seek or restore). Track number and drive number must be 

specified. Initially; a position head to track (restore) should be done 

before other disk I/O operations. A restore effectively resets the internal 

track register in the controller and can be done at any time to ensure the 

controller "knows where it is". 

Function 2, read sector, positions the head to the indicated track 

number and then reads in one 256 byte sector into the specified buffer 

area. Sector number, track number, buffer address and drive number 

must be specified. 

Function 3, write sector, operates similarly to read sector, except the 

data is transferred from the buffer are to the specified track and sector. 

Sector number, track number, buffer address and drive number must be 

specified. 

Function 4, read address ID, reads the six identification bytes from the 

first available sector of the given track into the specified buffer area. The 

format is track number, zeros, sector number, OIH, and two bytes of 

CRC (checksum) data. Sector number is not specified. Track number, 

buffer address and drive number must be specified. 

Function 5, read track, reads in the entire specified track into the buffer 

area. Approximately 3106 bytes must be made available as the buffer 

area. Gaps, ID data, address marks, data marks, and user data is read. 

Track number, buffer address and drive number must be specified. 

Function 6, write track, writes an entire track from the specified buffer 

area. The track data must be properly formatted because of hardware 

limitations in the controller. This operation is a "formatting" operation 

for initialization of the disk. Track number, buffer address and drive 

number must be specified. 



Examples 



Position Head to Track 
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LD 


IX,PARAM 


;parameter block address 


CALL 


DISKIO 


;call disk I/O 


return 




;(other code) 


PARAM DB 


1 


iposition function 


DB 





;sector # not required 


DB 





;track 


DB 





; buffer address not required 


DW 


1 




DB 





;zero TYC for return* 


DB 





;zero status for return* 


DB 


80H 


;wait, drive 


Read Sector 8, Track 13 (decimal) 




LD 


IX,PARAM 


;parameter block address 


CALL 


DISKIO 


;call disk I/O 


return 




;(other code) 


PARAM DB 


2 


;read sector function 


DB 


8 


;sector 8 


DB 


ODH 


;track 13 


DW 


BUFFER 


;buffer address 


DB 





;zero TYC for return* 


BD 





;zero status for return* 


DB 


81H 


;wait, drive 1 

* Not required 



Notes: 

1. Common furtctions used are position, read sector, and write sector. 

2. Additional information on disk operations appears earlier in this book. 

3. All registers are saved for return. 

4. Should you experience trouble with DISKIO, the problem may be 
incorrect code. If all code in DISKIO is correct, the checksum obtained 
by adding the contents of byte through 139H in the program should be 
6CH. If the checksum is not 6CH, code has been incorrectly entered 
manually or an error has been made in the source code for assembly. 
(The checksum is obtained by zeroing an 8 bit total, and then adding 
byte 0, byte 1,... through byte 139H. The resulting 8 bit value is the check 
sum, and should be 6CH.) 
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5000 


00100 




ORG 


5000H 




00110 


;************************ 




00120 


;* 








00130 


;* 




OISKIO-00 




00140 


.* 








00150 


;********«*******«******* 


0000 


00160 


CODE0 


EQU 


0000H 


0100 


00170 


CODEl 


EQU 


0100H 


078C 


00180 


C0DE2 


EQU 


078CH 


0FAC 


00190 


C0DE3 


EQU 


0FACH 


05C4 


00200 


C0DE4 


EQU 


05C4H 


05E4 


00210 


CODE 5 


EQU 


05E4H 


0OF4 


00220 


C0DE6 


EQU 


0DF4H 


0000 


00230 


STAT0 


EQU 





0018 


00240 


STATl 


EQU 


18H 


001C 


00250 


STAT2 


EQU 


ICH 


007C 


00260 


STAT 3 


EQU 


7CH 


001C 


00270 


STAT 4 


EQU 


ICH 


0004 


00280 


STATS 


EQU 


04H 


0044 


00290 


STAT6 


EQU 


44H 


5000 F5 


00300 


DISKIO 


PUSH 


AF 


5001 C5 


00310 




PUSH 


BC 


5002, D5 


00320 




PUSH 


DE 


5003 E5 


00330 




PUSH 


HL 


5004 AP 


00340 




XOR 


A 


5005 DD7705 


00350 




LD 


(IX+5),A 


5006 DO7706 


00360 




LD 


(IX+6),A 


500B DD7E00 


00370 




LD 


A, (IX) 


500B E6F8 


00380 




AMD 


0F8H 


5010 2073 


00390 




JR 


N2,IUVAL2 


5012 DD7E00 


00400 




LO 


A, (IX) 


5015 FE07 


00410 




CP 


7 


5017 286C 


00420 




JR 


2,INVAL2 


5019 DD7E07 


00430 




LD 


A,(IX+7) 


501C E67C 


00440 




AND 


7CH 


501E 2065 


00450 




JR 


N2,INVAL2 


5020 DD7E07 


00460 




LD 


A,(IX+7) 


5023 E603 


00470 




AND 


3 


5025 3C 


00480 




INC 


A 


5026 47 


00490 




LD 


B,A 


5027 3E80 


00500 




LO 


A,80H 


5029 07 


00510 


OISK0A 


RLCA 




502A 10FO 


00520 




OJNZ 


OISK0A 


502C 32B037 


00530 




LO 


(37E0H),A 


502F DDCB077E 


00540 




BIT 


7,(IX+7) 


5033 2809 


00550 




JR 


Z,OISK01 


5035 210000 


00560 




LO 


HL,0000 


5038 25 


00570 


OISK0B 


DEC 


H 


5039 20FO 


00580 




JR 


NZ,OISK0B 


503B 2D 


00590 




DEC 


L 


503C 20FA 


00600 




JR 


NZ,DISK0B 


503E 3AEC37 


00610 


DISK01 


LO 


A,(37ECH) 


5041 CB47 


00620 




BIT 


0,A 


5043 20F9 


00630 




JR 


NZ,DISK01 


5045 DO7E00 


00640 


DISK02 


LO 


A, (IX) 


5048 010000 


00650 




LO 


BC,COOE0 


504B 1E00 


00660 




LO 


E,STAT0 


5040 FE00 


00670 




CP 





504F 2836 


00680 




JR 


Z,OISK03 


5051 010001 


00690 




LO 


BCCOOBl 


5054 1E18 


00700 




LO 


E, STATl 


5056 FE01 


00710 




CP 


1 


5058 2820 


00720 




JR 


Z,OISK03 


505A 018C07 


00730 




LO 


BC,C00B2 


5050 lElC 


00740 




LO 


E,STAT2 


505F FE02 


00750 




CP 


2 


5061 2824 


00760 




JR 


Z,DISK03 


5063 01AC0F 


00770 




LO 


BC,C00B3 


5066 1E7C 


00780 




LO 


E, STAT 3 


5068 FE03 


00790 




CP 


3 



;SAVE REGS 

;ZERO A 
•ZERO TYC 
;ZERO STATUS 
;GET FUNCTION 

;GO IF INVALID FUNCTIC 

;GO IF FUNCTION 7 

;GET DRIVE 
;G0 IF GT 3 



;CONVERT TO POSITION 

; SELECT 

;TEST W 

;GO IF NO WAIT 



;DELAY 64K COUNTS 
;GET STATUS 
;TEST BUSY 
;G0 IF BUSY 
;GET FUNCTION 6 
;LOAD SEQ COMMAND 
;STATUS CHECK BITS 



506A 281B 


00800 




JR 


Z,DISK03 


506C 01C405 


00810 




LD 


BC,C0DE4 


506F lElC 


00820 




LD 


E,STAT4 


5071 FE04 


00830 




CP 


4 


5073 2812 


00840 




JR 


Z,DISK03 


5075 01E405 


00850 




LD 


BC,C0DE5 


5078 1E04 


00860 




LD 


E, STATS 


507A FE05 


00870 




CP 


5 


507C 2809 


00880 




JR 


Z,OISK03 


507E 01F40D 


00890 




LD 


8C,C0DE6 


5081 1E44 


00900 




LD 


E,STAT6 


5083 1802 


00910 




JR 


DISK03 


5085 1834 


00920 


INVAL2 


JR 


INVALl 


5*087 CB40 


00930 


DISK03 


BIT 


0,8 


5089 2847 


00940 




JR 


Z,OISK08 


508B DD7E02 


00950 




LD 


A, {IX+2) 


508E E6E0 


00960 




AND 


0E0H 


5090 280F 


00970 




JR 


Z,DISK04 


5092 DO7E02 


00980 




LD 


A, (IX+2) 


5095 FE20 


00990 




CP 


32 


5097 2808 


01000 




JR 


Z,DISK04 


5099 FE21 


01010 




CP 


33 


509B 2804 


01020 




JR 


Z,DISK04 


5090 FE22 


01030 




CP 


34 


509F 201A 


01040 




JR 


NZ, INVALl 


50A1 DD7E02 


01050 


DISK04 


LD 


A, (IX+2) 


50A4 87 


01060 




OR 


A 


50A5 2004 


01070 




JR 


NZ,DISK05 


50A7 3E03 


01080 




LD 


A, 3 


50A9 1807 


01090 




JR 


DISK06 


50AB 32EF37 


01100 


OISK05 


LO 


(37EFH) ,A 


50AE C5 


01110 




PUSH 


BC 


50AF CI 


01120 




POP 


BC 


5080 3E17^ 


01130 




LO 


A,17H 


5082 32E/37 


01140 


DISK06 


LO 


(37EeH) ,A 


50B5 C5 C 


01150 




PUSH 


BC C 


5086 CI 


01160 




POP 


BC 


5087 C5 


01170 




PUSH 


BC 


5088 CI 


01180 




POP 


BC 


5089 1802 


01190 




JR 


DISK07 


5088 1879 


01200 


INVALl 


JR 


INVAL 


508D 3AEC37 


01210 


OISK07 


LD 


A,{37ECH) 


50C0 CB47 


01220 


, 


BIT 


0,A 


50C2 20F9 


01230 




JR 


NZ,DISK07 


50C4 DD7706 


01240 




LD 


(IX+6),A 


50C7 E698 


01250 




AND 


98H 


50C9 2807 


01260 




JR 


Z,OISK08 


50CB 3EFD 


01270 




LD 


A,0FOH 


50CD DD7705 


01280 




LO 


(IX+5),A 


5000 185F 


01290 




JR 


OISK27 


5002 CB48 


01300 


OISK08 


BIT 


1»B 


50D4 2817 


01310 




JR 


Z,OISR10 


50D& DD7E01 


01320 




LO 


A,(IX+1) 


5009 E6F8 


01330 




AND 


0F8H 


5008 DD7E01 


01340 




LD 


A,{1X+1) 


50OE'2808 


01350 




JR 


Z,OISK09 


50E0 FE08 


01360 




CP 


8 


50E2 2804 


01370 




JR 


Z,OISK09 


50E4 FE09 


01380 




CP 


9 


50B6 204E 


01390 




JR 


NZ, INVAL 


50E8 32EE37 


01400 


DISK09 


LO 


(37EEH),A 


50E8 C5 


01410 




PUSH 


BC 


50EC CI 


01420 




POP 


BC 


50EO CB50 


01430 


DISK10 


BIT 


2,8 


50EF 05 


01440 




PUSH 


OB 


50F0 282E 


01450 


C)ISK12 


JR 


Z,OISK20 


50F2 79 


01460 




LO 


A,C 


50F3 OO5E03 


01470 




LO 


E,{IX+3) 


50F6 005604 


01480 




LO 


0,(IX+4) 


50P9 21EC37 


01490 




LO 


HL,37ECH 



;GET TRACK BIT 
fGO IF ZERO 
;GET TRACK » 

;G0 IF 0-31 



;G0 IF 32 

;G0 IF 33 

;G0 IF GT 34 
; TRACK « 

;G0 IF NOT RESTORE 
; RESTORE COMMAND 

; OUTPUT TRK | 
; WASTE TIME 

;SEEK COMMAND 

•OUTPUT RESTORE OR SEEK 

; WASTE TIME 



;GET STATUS 
;TEST BUSY 
;G0 IF BUSY 
; STORE STATUS 
;TEST STATUS 
;G0 IF OK 

;SET POSITION ERROR 
;TERMINATB 

'/GET SECTOR BIT 
;G0 IF 
iGBT SECTOR 



;G0 IF 0-7 
;G0 IF 8- 

;G0 IF GT9 

; OUTPUT TO SECTOR REG 



;GET REAO/WR BIT 

jSAVE STATUS CHK BITS 

;G0 IF NO I/O 

;GBT COMMAND 

; BUFFER ADORES^ LS 

;MS 

; STATUS REG ADORS 



54 



55 



50FC 


77 


01500 




LD 


{HL),A 


; OUTPUT COMMAND 




50FD 


CB58 


01510 




BIT 


3,B 


;TEST RD/WR 




SaPF 


C5 


01520 




PUSH 


BC 






5100 


CI 


01530 




POP 


BC 


; WASTE TIME 




5101 


C5 


01540 




PUSH 


BC 






5102 


CI 


01550 




POP 


BC 






5103 


01EF37 


01560 




LD 


BC,37EFH 


;DATA REG ADDRS 




5106 


280C 


01570 




JR 


Z,DISK18 


;G0 IF READ 




5108 


7E 


01580 


DISK15 LD 


A,(HL) 


;GET STATUS 




5109 


0F 


01590 




RRCA 




;BUSY TO C 




510A 


3014 


01600 




JR 


NC,D1SK20 


;G0 IF DONE 




510C 


0F 


01610 




RRCA 




;DRQ TO C 




510D 


30F9 


01620 




JR 


NC,DISK15 


;G0 IF NOT RDY 




510F 


lA 


01630 




LD 


A,(DE) 


;GET BYTE 




5110 


02 


01640 




LD 


(BC),A 


; OUTPUT TO DISK 




5111 


13 


01650 




INC 


DE 






5112 


18F4 


01660 




JR 


DISK15 


; CONTINUE 




5114 


7E 


01670 


DISK18 LD 


A,(HL) 


;GET STATUS 




5115 


0F 


01680 




RRCA 




;BUSY TO C 




5116 


3008 


01690 




JR 


NC,DISK20 


;G0 IF DONE 




5118 


0F 


01700 




RRCA 




;DRQ TO C 




5119 


30F9 


01710 




JR 


NC,DISK18 


;G0 IF NOT RDY 




511B 


0A 


01720 




LD 


A,(BC) 


jGET BYTE 




511C 


12 


01730 




LD 


(DE),A 


; STORE 




511D 


13 


01740 




INC 


DE 






511E 


18F4 


01750 




JR 


DISR18 


/CONTINUE 




5120 


3AEC37 


01760 


DISK20 LD 


A,(37ECH) 


;GET STATUS 




5123 


DD7706 


01770 




LD 


(IX+6),A 


;SAVE 




5126 


CI 


01780 




POP 


BC 


; RESTORE STATUS CHK 


B 


5127 


Al 


01790 




AMD 


C 


;TEST 




5128 


3E01 


01800 




LD 


A,l 






512A 


2802 


01810 




JR 


Z,OISK25 


;G0 IF OK 




512C 


3EFF 


01820 




LD 


A,0FFH 






512E 


DD7705 


01830 


OISK25 LD 


(IX+5),A 


;SET ERROR TYC 




5131 


El 


01840 


DISK27 POP 


HL 






5132 


Dl 


01850 




POP 


DE 






5133 


CI 


01860 




POP 


BC 






5134 


Fl 


01870 




POP 


AF 


/RESTORE REGS 




5135 


C9 


01880 




RET 








5136 


3EFE 


01890 


INVAL 


LD 


A,0FEH 






5138 


18F4 


01900 




JR 


DISK25 






0000 




01910 




END 








00008 


TOTAL 


ERRORS 












COOE0 


0000 


00160 


00650 










CODEl 


0100 


00170 


00690 










CODE 2 


078C 


00180 


00730 










CODE 3 


0FAC 


00190 


00770 










CODE 4 


05C4 


00200 


00810 










CODES 


05E4 


00210 


00850 










C0DE6 


0DF4 


00220 


00890 










OISK01 503E 


00610 


00550 


00630 








DISK02 5045 


00640 












DISK03 5087 


00930 


00680 


00720 00760 00800 00840 


00880 00910 




DISK04 50A1 


01050 


00970 


01000 01020 






DISK05 50AB 


01100 


01070 










OISK06 50B2 


01140 


01090 










DISK07 50BD 


01210 


01190 


01230 








DISK08 50D2 


01300 


00940 


01260 








DISK09 50E8 


01400 


01350 


01370 








DISK0A 5029 


00510 


00520 










OISK0B 5038 


00570 


00580 


00600 








DISK10 50ED 


01430 


01310 










DISK12 50F0 


01450 












DISK15 5108 


01580 


01620 


01660 








0ISK18 5114 


01670 


01570 


01710 01750 






OISK20 5120 


01760 


01450 


01600 01690 






DISK25 512£ 


01830 


01810 


01900 








DISK27 5131 


01840 


01290 











DISKIO 


5000 


00300 






INVAL 


5136 


01890 


01200 


01390 


INVALl 


508B 


01200 


00920 


01040 


INVAL2 


5085 


00920 


00390 


00420 00450 


STAT0 


0000 


00230 


00660 




STATl 


0018 


00240 


00700 




STAT 2 


001C 


00250 


00740 




STAT3 


007C 


00260 


00780 




STAT 4 


001C 


00270 


00820 




STAT 5 


0004 


00280 


00860 




STAT 6 


0044 


00290 


00900 





